Formål og målgruppe

Formålet med HTTP API beskrivelsen er at gøre det muligt for potentielle udviklere at lave løsninger, som laver opslag i tingbogen. Beskrivelsen dækker kun services til at lave forespørgsler mod tingbogen. Selve udviklingen af klient softwaren er ikke en del af denne beskrivelse.

Redundant information mellem indholdet i denne manual og andre dokumenter vil holdes på et minimum, dog med hensyntagen til læsbarheden. I tilfælde af uoverensstemmelse vil de refererede dokumenter være gældende.

Målgruppen er arkitekter og udviklere, der skal udvikle forespørgselsapplikationer som laver opslag i tingbogen.

Referencer

S2S-002 Schema-dokumentation: Beskrivelse af system-system-snitfladen. Du kan downloade den seneste S2S Dokumentation ZIP-pakke fra Tinglysningsrettens officielle hjemmeside for professionelle brugere: Tinglysningsretten - eTL for professionelle brugere (Se efter "S2S Dokumentation").

HTTP API til søgning og forespørgsel

Tinglysning HTTP API’et er fordelt på flere base URLs for at understøtte forskellige godkendelsesmetoder og integrationsmønstre.

Vigtigt: Fra den 6. november 2026 (Release 55) vil SSL-base URLs blive konsolideret. Se oversigten nedenfor for detaljer.

Base URL (udfases ved Release 55) Base URL fra Release 54 Authentication

https://tinglysning.dk/tinglysning/ssl/

https://rest-api.tinglysning.dk/

2-vejs SSL med et OCES-systemcertifikat

https://tinglysning.dk/tinglysning/unsecuressl/

https://rest-api.tinglysning.dk/

2-vejs SSL med et OCES-systemcertifikat

Generelt er svar på søgninger formateret i JSON, og svar på endelige opslag formateret i XML. I svarene på en søgning vil de fundne objekter typisk være identificeret ved et UUID, som efterfølgende kan bruges ved opslag.

I eksemplerne i API oversigten er de benyttede uuider og andre data ikke ægte.

SSL

Alle endpoints er beskyttet via. to-vejs-SSL-authentication og kræver derfor et medsendt systemcertifikat udstedt af den danske stat (OCES3). Yderligere, kræves det at virksomheden tilknyttet certifikatet er oprettet som systembruger.

Hvis et systemcertifikat ikke er gyldigt eller mangler, eller hvis virksomheden ikke er registreret, vil serveren svare med en 401 Unauthorized-fejl.

Nedenfor er angivet et simpelt test eksempel på hvordan dette kan gøres i C#.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

DoSSLTest(@"C:\<sti til cert>\FOCES_gyldig.p12");

private void DoSSLTest(String foces_path)
{
    try
    {
        X509Certificate2 clientCertificate = new X509Certificate2(foces_path, "<password>");
        CertificateWebClient myWebClient = new CertificateWebClient(clientCertificate);
        String test = @"https://test.tinglysning.dk/tinglysning/ssl/dokaktuel/uuid/3fdd57ef-0e5e-4879-9dd9-ff613dc88a82";
        test = myWebClient.DownloadString(test);
        Console.WriteLine(test);
    }
    catch (WebException wex)
    {
        if (wex.Response != null)
        {
            System.Net.HttpWebResponse resp = wex.Response as System.Net.HttpWebResponse;
            StreamReader streamReader = new StreamReader(resp.GetResponseStream(), System.Text.Encoding.UTF8);
            String body = streamReader.ReadToEnd();
            Console.WriteLine(body);
        } else
        {
            Console.WriteLine(wex.Message);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }
}

class CertificateWebClient : WebClient
{
    private readonly X509Certificate2 certificate;
    public CertificateWebClient(X509Certificate2 cert)
    {
        certificate = cert;
    }
    protected override WebRequest GetWebRequest(Uri address)
    {
        HttpWebRequest request = (HttpWebRequest)base.GetWebRequest(address);
        System.Net.ServicePointManager.ServerCertificateValidationCallback = delegate (Object obj, X509Certificate X509certificate, X509Chain chain, System.Net.Security.SslPolicyErrors errors)
        {
            return true;
        };
        if (!request.ClientCertificates.Contains(certificate))
        {
            request.ClientCertificates.Add(certificate);
        }
        return request;
    }
}

API Oversigt

Fast ejendom

Endpoint Beskrivelse

SoegningAdresse

Søgning efter fast ejendom ved hjælp af adresseoplysninger. Der kan søges med eller uden etage og side/dør.

SoegningBFE

Søgning efter fast ejendom ved hjælp af hovednoteringsnummer (BFE-nr.).

SoegningUMA

Søgning efter fast ejendom via et umatrikuleret areal (UMA) identifikator.

SoegningMatrikel

Søgning efter fast ejendom ved at angive landsejerlavid og matrikelnummer.

EjendomSummarisk

Hent omfattende ejendomssammendragsoplysninger ved hjælp af ejendommens UUID.

HistoriskAdkomst

Hent historiske adkomstoplysninger for en ejendom ved hjælp af dens UUID.

Andelsboliger

Endpoint Beskrivelse

SoegningAdresse

Søgning efter andelsboliger ved hjælp af adresseoplysninger (postnummer og vejnavn). Der kan søges med eller uden etage og side/dør.

SoegningNavnFoedselsdato

Søgning efter andelsboliger ved hjælp af debitors navn og fødselsdato.

SoegningKommunevej

Søgning efter andelsboliger ved hjælp af kommunekode og vejkode. Der kan søges med eller uden etage og side/dør.

SoegningCvr

Søgning efter andelsboliger ved hjælp af CVR-nummer.

OpslagUUID

Søgning efter summariske oplysninger for andelsbolig via UUID. Returneres som XML. UUID kan findes via anden søgning på andelsbolig.

Køretøjer (Bil)

Endpoint Beskrivelse

OpslagUUID

Hent de fulde summariske oplysninger for et køretøj ved hjælp af dets UUID.

SoegBil

Søgning efter køretøjer ved hjælp af stelnummer, CVR-nummer eller navn med fødselsdato.

Bilag

Endpoint Beskrivelse

HentBilag

Hent et bilag direkte ved hjælp af dets UUID. Kun offentlige bilag er tilgængelige.

Dokument

Endpoint Beskrivelse

DokumentByUuid

Hent aktuelle dokumentoplysninger ved hjælp af dets UUID.

DokumentByAlias

Hent aktuelle dokumentoplysninger ved hjælp af dets alias (dato-løbenummer).

FindByAlias

Find et dokument ved hjælp af dets alias og returnér grundlæggende oplysninger.

Dokumentpåtegninger (Paategning)

Endpoint Beskrivelse

PaategningByUuid

Hent dokumentpåtegninger ved hjælp af dokumentets UUID.

PaategningByAlias

Hent dokumentpåtegninger ved hjælp af dokumentets alias.

Personbog

Endpoint Beskrivelse

PersonSummarisk

Hent summariske oplysninger for en person/virksomhed i personbogen ved hjælp af deres UUID.

SoegPersonbog

Søg efter personer/virksomheder i personbogen ved hjælp af navn og CPR-nummer.

SoegPersonbogCvr

Søg efter personer/virksomheder i personbogen ved hjælp af CVR-nummer eller navn med fødselsdato.

Virksomhed

Endpoint Beskrivelse

SoegVirksomhedCvr

Søg efter dokumenter relateret til en virksomhed ved hjælp af CVR-nummer.

GetDokumenttyper

Hent en liste over tilgængelige dokumenttyper til brug i søgninger.

GetRolletyper

Hent en liste over tilgængelige rolletyper til brug i søgninger.

HarRegistreringer

Kontrollér om en virksomhed har registreringer i systemet.

Tinglysningsobjekter

Endpoint Beskrivelse

TinglysningsobjektByUuid

Hent tinglysningsobjektoplysninger ved hjælp af dets UUID.

TinglysningsobjektByAlias

Hent tinglysningsobjektoplysninger ved hjælp af dets alias.

AendredeTinglysningsobjekter

Find tinglysningsobjekter der er blevet modificeret inden for et datointerval.

SenesteAendring

Find den seneste ændringsdato for et specifikt tinglysningsobjekt.

PDF Generering

Endpoint Beskrivelse

PdfEjendomSummarisk

Generér et PDF-dokument indeholdende ejendomssammendrag.

PdfPaategning

Generér et PDF-dokument for specifikke dokumentpåtegninger.

PdfAtdByUuid

Generér et PDF-dokument for ATD ved hjælp af UUID.

PdfAtdByAlias

Generér et PDF-dokument for ATD ved hjælp af alias.